home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 0756 / readme. < prev   
Text File  |  1997-04-09  |  13KB  |  295 lines
  1.                              ARF
  2.  
  3.                        Copyright 1996
  4.                             by
  5.                   Bitsafe Computer Services
  6.  
  7.                   425 S. Bird St. #110
  8.                   Sun Prairie, WI 53590
  9.                   Email: bitsafe@execpc.com
  10.               http://www.execpc.com/~bitsafe/arf
  11.  
  12.                         All right reserved
  13.  
  14. -------------------------------------------------------------------
  15.  
  16.  
  17. What is Arf?
  18.  
  19.     Arf is a World Wide Web database search and retrieval agent.
  20.  
  21.     Arf searches web databases such as Alta Vista, Lycos, and
  22.     Deja News, and retrieves documents that they reference.
  23.  
  24.  
  25. How do you use Arf?
  26.  
  27.     Use your favorite browser to do a preliminary search.
  28.     Then, once you've narrowed down what your search term should
  29.     be, fire up Arf.
  30.  
  31.     Type in your search term and tell Arf which database to contact.
  32.     Arf contacts that database and tells it to do a search. The
  33.     database sends back lists of web pages (or Usenet posts in
  34.     the case of Deja News). Arf goes out on the Internet, gets
  35.     those web pages, and copies them to your hard disk.
  36.  
  37.  
  38. What are the benefits of Arf?
  39.  
  40.     Get every page.  Arf doesn't forget a single one.
  41.     Save time.       Arf searches faster than any human.
  42.     Save money.      Connect time is reduced to a minimum.
  43.  
  44.     Do other things while Arf searches for you.    
  45.     View your search results offline - with no network lag.
  46.     Search more than one database at a time
  47.         - by starting several copies of Arf.
  48.  
  49.     Arf is great for writers and other researchers.
  50.  
  51.  
  52. Installing Arf
  53.  
  54.     1) Put cswsock.vbx in your \windows\system directory.
  55.  
  56.     2) Put arf3.ini in your \windows directory.
  57.  
  58.     3) Put arf.exe & Readme in whatever directory you want.
  59.  
  60.     You are now probably done, but check out the next few
  61.     steps.
  62.  
  63.     4) Arf needs three additional files to run, cmdialog.vbx,
  64.     commdlg.dll, and vbrun300.dll. If cmdialog.vbx and
  65.     commdlg.dll are NOT already present in \windows\system,
  66.     then put the supplied copies there.
  67.  
  68.     5) Vbrun300.dll is not included in Arf's zip file because
  69.     of its size and because you probably already have a copy.
  70.     If you don't, it is available from the Arf site at
  71.     www.execpc.com/~bitsafe/arf and from Simtel.net and many
  72.     on-line services and BBSs. Just put a copy of it in
  73.     \windows\system, if necessary.
  74.  
  75.     6) If you want, you can set an icon to point to Arf by doing:
  76.         "File->New->Program item" in Windows 3.1
  77.         or
  78.         "New->Shortcut" in Windows 95 & NT
  79.  
  80.     7) Arf uses a configuration file to save your favorite settings
  81.     (see below). By default this file will be named
  82.     c:\windows\arf3.ini. You can change this, if you want, by
  83.     inserting a line like:
  84.  
  85.         set ARFCONFIG=c:\my_dir\my_config_file
  86.  
  87.     in your autoexec.bat file, but this isn't required at all.
  88.  
  89.  
  90. Using Arf
  91.  
  92.     First make sure you are connected to the Internet.
  93.  
  94.     Type a search term in the text box labeled "For:" (try
  95.     the word "bitsafe"). Then choose your database in the
  96.     box just above it (or leave it at Alta Vista). Then press
  97.     the "Start" button. The Start button will change into a
  98.     Stop button, and you should start to see informational
  99.     messages appearing in the "Messages" box near the bottom
  100.     of Arf.
  101.  
  102.     When Arf has finished, take a look in the directory
  103.     "c:\arfout". You should see several files named:
  104.     page1.htm, page2.htm, etc. These are the html pages that
  105.     Arf fetched from the Internet. You can look at these using
  106.     any editor or by using a web browser such as Netscape or
  107.     Explorer.
  108.  
  109.     You will also find two other files in c:\arfout:
  110.     "fetched.htm" and "badlinks.htm". Fetched.htm is an html
  111.     file that Arf created. It has html links in it that point
  112.     to the "page.htm" files. Try looking at it with your
  113.     browser and clicking on the links - you can view all the
  114.     web pages that Arf fetched very easily by clicking on
  115.     the links within fetched.htm. Then use the "back"
  116.     button in your browser to quickly go back to the
  117.     fetched.htm page. You can tell Arf to use another name
  118.     for fetched.htm in the "Name of fetched.htm file" box.
  119.  
  120.     The file badlinks.htm contains links to web pages that
  121.     Arf was unable to fetch (this can happen when a web
  122.     server is down or when the location of a web page has
  123.     changed, but the link to it has not). You can try viewing
  124.     those pages at some other time.
  125.  
  126.     At the bottom of each fetched page is a link labeled
  127.     "original page". If you click on the link and are still
  128.     connected to the Internet, you can view the original page
  129.     complete with graphics (Arf does not copy graphics).
  130.     You can tell Arf to put the "original page" link at the
  131.     top of the page instead by using the
  132.     "Placement of 'original page' link" box.
  133.  
  134.     If you now do another search with Arf, you will find
  135.     that Arf places more web page files in c:\arfout
  136.     without deleting or overwriting the web pages produced
  137.     by your first search. In addition, Arf adds new links
  138.     in the fetched.htm file without destroying the old
  139.     links.
  140.  
  141.     If you want Arf to put its results in some other
  142.     directory, then change the text box labeled "Directory:".
  143.     If you want to change the names of the pages that Arf
  144.     fetches, change the text box labeled "Prefix:".
  145.     NB: Filename prefixs under Windows 3.1 can only be 8
  146.     characters long - Arf truncates the prefix, if necessary,
  147.     under 3.1)
  148.  
  149.     The "Max Links" box on Arf limits how many pages Arf can
  150.     look for on each search. The free version of Arf is
  151.     limited to just ten links. The registered version can do
  152.     10,000 links.
  153.  
  154.     Some pages out on the web are enormous. You can limit
  155.     how many bytes of a page Arf will download by using
  156.     the "Bytes per page"" box. It limits how many bytes
  157.     of a page will be copied to your disk drive.
  158.  
  159.     When Arf is doing a search, it has to wait for the
  160.     database it is searching to respond with data. You can
  161.     tell Arf how long to wait before breaking contact and
  162.     maybe trying again. You do this by setting the Database
  163.     Timeout text box to the number of seconds you want it
  164.     to wait. Similarly, you control how long Arf will wait
  165.     for a web server to deliver a web page by setting the
  166.     Pages Timeout text box.
  167.  
  168.     You can have Arf not fetch some of the pages it encounters
  169.     by setting the "Skip links" text boxes. For example, to
  170.     have Arf skip the first ten pages set the "From:" box to
  171.     1 and set the "To:" box to 10.
  172.  
  173.     As Arf operates, it tells you how things are going in the
  174.     "Statistics" text boxes. The "Links followed:" box tells
  175.     you how many database links Arf has followed. The
  176.     "Pages fetched:" box indicates how many of those links
  177.     Arf was able to follow and successfully retrieve a web
  178.     page.
  179.  
  180.     Arf has another way to tell you what is doing. Just above the
  181.     Start button is a green square. When Arf is talking to a
  182.     database, this square becomes red. When Arf is busy fetching
  183.     a web page this square becomes blue. When the square is blue,
  184.     you can use your mouse to click on it. This causes Arf to
  185.     quit trying to fetch that page and go on to the next one.
  186.     This is referred to as skipping a page. If Arf has managed
  187.     to transfer part of a page, it will not delete what it has
  188.     managed to get. You can, of course, press the Stop button
  189.     at any time to have Arf terminate a search completely.
  190.  
  191.     One quick note and then we'll move on to some of the more
  192.     advanced facilities in Arf: When you type a search term in
  193.     the "For:" text box, you have to use the syntax of the
  194.     database you are going to connect to. You can find out what
  195.     these syntax rules are by using a browser to contact the
  196.     database.
  197.  
  198.  
  199. Advanced usage
  200.  
  201.     Arf has the ability to start your favorite browser when you
  202.     press the "Browser" button, but first you have to tell Arf
  203.     where your browser is. Press the menu "File->Select browser".
  204.     This creates a popup box which you use to find your browser.
  205.     When you have located it, press the "Ok" button. Now, do a
  206.     search. When the search is done, press the "Browser" button
  207.     and your web browser will start up. If your browser is the
  208.     one from Netscape, your browser will try to load fetched.htm
  209.     automatically!
  210.  
  211.     Another thing you can do is to change Arf's appearance to suit
  212.     your own taste in colors. Use the "Color" menu to set the
  213.     colors of Arf's text boxes, the colors of the frames that the
  214.     text boxes are in, and the overall background color of Arf.
  215.  
  216.     After you have told Arf about the location of your browser
  217.     and set a few colors, be sure to save your settings by using
  218.     the "File->Save configuration" menu. Arf will save your
  219.     settings in the file "c:\windows\arf3.ini" and use those
  220.     settings the next time you use the program. If you'd rather
  221.     have Arf put this information in another file, then edit in
  222.     your autoexec.bat file so that it has a line like:
  223.  
  224.         set ARFCONFIG=c:\my_dir\my_config_file
  225.  
  226.     (You will have to reboot for this to take effect).
  227.  
  228.     Arf saves the following information in its configuration file:
  229.         Arf's screen location
  230.         the current web database
  231.         the current search term in the "For:" box
  232.         the "Skip links" textbox settings
  233.         the web page directory and prefix settings
  234.         the database and web page timeout settings
  235.         maximum number of pages to fetch
  236.         the name of "fetched.htm"
  237.         maximum number of bytes in a fetched page
  238.         where to put the 'original page' link
  239.         the location of your web browser
  240.         and all your color settings.
  241.  
  242.  
  243.     That's about it. Arf is not hard to use. If you like Arf, then
  244.     tell other people about it and upload the free version to a
  245.     local bulletin board. Please do not pirate the program. Hope
  246.     you enjoy using Arf.
  247.  
  248. New
  249.  
  250.     Starting with version 3.0, Arf now uses data from the
  251.     configuration file, arf3.ini, to guide it in parsing responses
  252.     from web databases. This means Arf will not go out of date
  253.     just because a database changes the form of its output.
  254.     It also means that Arf will be able to deal with new
  255.     databases as they come online.
  256.  
  257.     When a new database appears or an old one changes, the
  258.     configuration file will have to change. The latest configuration
  259.     file will be on Arf's web page at www.execpc.com/~bitsafe/arf.
  260.  
  261. Proxy servers
  262.  
  263.     Some sites use a proxy server as a firewall to protect their
  264.     internal network. Starting with version 3.1, Arf can deal with
  265.     proxy servers. Click on the "Proxy" menu. A popup box appears
  266.     where you can enter the address of your proxy server. Click on
  267.     the "Use proxy" check box and you are ready to start searching.
  268.     Be sure to save your settings by using the
  269.     "File->Save configuration" menu.
  270.  
  271. New in 3.2
  272.  
  273.     A new options menu popup has three check boxes that let you:
  274.  
  275.         write links - 
  276.             Tells Arf to write all the links it receives from a database into
  277.             a file named links (in the same directory where your downloaded
  278.             pages are written).
  279.  
  280.         write pages -
  281.             Tells Arf whether or not to actually follow links and download
  282.             pages. By turning "write links" on and "write pages" off, you
  283.             can have Arf run a query and just dump the links it finds to
  284.             the links file. This is a fast operation. You can then feed these
  285.             links into other software programs.
  286.  
  287.         adjust image links -
  288.             Tells Arf to parse pages as they are being downloaded, looking
  289.             for hypertext links to images. The links are adjusted so that
  290.             they point back to the original locations of the images. This
  291.             allows you to view your downloaded files with graphics if you
  292.             are online and your browser is set to autoload images. Also,
  293.             due to the caching nature of browsers and/or proxy servers,
  294.             it enables you to see the graphics when you are off line,
  295.             if you have previously visted that site.